home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / dev / lang / J4thDemo.lha / ReadME < prev    next >
Encoding:
Text File  |  1994-02-26  |  5.0 KB  |  118 lines
  1.  
  2.                 WELCOME TO THE JFORTH DEMO DISK!
  3.     
  4.     This is a demo of JForth Professional V3, one of the most 
  5.     powerful and sophisticated flavors of the Forth programming 
  6.     language available.
  7.     
  8.     EVEN IF YOU ARE NOT A PROGRAMMER, this disk will benefit you,
  9.     because we've included 2 commercial-quality, useful applications.
  10.     
  11.     First, there's TEXTRA V1.11, the user-friendly text editor
  12.     with ARexx (plus documentation and ARexx scripts).  This is
  13.     a general purpose, standard text editor with a focus on
  14.     ease-of-use.  Textra can function as an integrated editor with
  15.     JForth via ARexx.
  16.     
  17.     Also included is the LCD Calculator, which was noted in 
  18.     mid-1991 issues of both AmigaWorld and .INFO (the latter 
  19.     even displayed a screenshot).  (Please note that the LCDIFF 
  20.     drawer must reside either in the same drawer as LCD 
  21.     Calculator, or in sys:utilities).  (NOTE: This demo contains
  22.     the newer LCD Calculator II program, which includes printing
  23.     and a color requester!)
  24.     
  25.     Feel free to distribute this disk, including TEXTRA and the 
  26.     LCD Calculator to user groups and your friends, but PLEASE pass 
  27.     this disk around in its entirity!
  28.     
  29.     (Incidentally, TEXTRA and LCD Calculator are both written in 
  30.     JForth; they are standalone programs produced with the CLONE 
  31.     facility, one of JForths many unique and advanced features.)
  32.     
  33.     For those that ARE interested in programming, this disk should 
  34.     prove a treat!  It contains a functional but limited JForth 
  35.     compiler and interpreter in conjunction with example programs, 
  36.     tutorials, and a compiled "Introduction" program available in the 
  37.     JForth program startup.
  38.     
  39.     The "Example_Program" executable is another CLONEd JForth 
  40.     program.  It utilizes many Amiga facilities such as graphics 
  41.     (including a HAM mode demo), menus, sprites etc.  The JForth 
  42.     source code for "Example_Program" is not provided with this 
  43.     demo, but does come with the JForth product release.  These, 
  44.     as well as the source for other 'demos' in addition to some 
  45.     real, useful tools (such as 'wordcount.f ', which IS 
  46.     included in this demo package) provide the customer with a 
  47.     multitude of example JForth-Amiga programming techniques for 
  48.     accessing your Amiga's Intuition, graphics, menus, ARexx, 
  49.     and animation capabilities and more.
  50.     
  51.     The standard JForth product includes complete Amiga 2.0 include
  52.     support files, in JForth '.j' form, as well as the means for
  53.     accessing all standard and custom Amiga shared-libraries.
  54.     While the include files are not included in this Demo compiler,
  55.     many Amiga data structures and system calls have been pre-compiled
  56.     for you.  Their use is described in the "Tutorials/Tutorial" file.
  57.     
  58.     With this demo, you can compile and examine the provided 
  59.     source code programs and get a feel for programming in 
  60.     Forth.  You can observe the crisp, immediate aspect of the 
  61.     JForth interpreter, allowing "direct access" to all levels 
  62.     of the machine.  Hopefully, you will appreciate the 
  63.     interactivily of the language, allowing you to compile 
  64.     high-level programs from the keyboard, and examine, even 
  65.     execute subroutines individually in the same manner.  The 
  66.     compiled Source-Level Debugger may be be of interest.  Or 
  67.     opening windows and making graphics calls one-at-a-time from 
  68.     the keyboard...  INTERACTIVELY!
  69.     
  70.     Anything is possible with Forth... JForth!
  71.     
  72.     
  73.     To get the most from this demo, may we suggest...
  74.     
  75.     o  Play with the "Example_Program"
  76.     
  77.     o  Run the "JForth_Demo" program and view the 'Intro' program.
  78.     
  79.     o  You may want to run your Amiga in Hires-Interlaced mode, 
  80.        so that both your text-editor/viewer and JForth may be 
  81.        easily visible at the same time.  OR...
  82.        Some may prefer to print out the tutorials to follow with 
  83.        hardcopy, perhaps taking notes (The Textra editor will 
  84.        print text files, paying attention to the system Printer 
  85.        Preferences AND with optional line numbers and/or a 'page 
  86.        header' line at the top of each page).
  87.     
  88.     o  Pathnames in the tutorials & intros are relative to the 
  89.        topmost directory, the one containing the "JForth_Demo" 
  90.        program.  (If you launch it from shell, you should CD to 
  91.        the same directory as the program.  If you double-click 
  92.        the "JForth_Demo" program, this is automatically the 
  93.        case).
  94.        
  95.     o  View the text files in the 'Tutorials' directory in this
  96.        order...
  97.        
  98.        1. Overview
  99.        2. Tutorial
  100.        3. Grand_Tour
  101.        4. More_Commands
  102.     
  103.     o  INCLUDE each of the files in the 'Programs' drawer, and play
  104.        with them, disassemble parts of them, look at their source
  105.        code.
  106.     
  107.     
  108.     We hope you enjoy this JForth Demo.
  109.     
  110.     Ask for JForth Professional V3 at your local Amiga software 
  111.     dealer.
  112.     
  113.                Delta Research
  114.               P.O. Box  151051
  115.          San Rafael, CA. 94915-1051
  116.     
  117.               (415) 453-4320
  118.